home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / copy.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  3.7 KB  |  115 lines
  1. COPY
  2.  
  3. Copies files or directories.
  4.  
  5. Format
  6.  
  7. COPY [FROM] {<name | pattern>} [TO] <name> [ALL] [quiet] [BUF | BUFFER=<n>]
  8. [CLONE] [DATES] [NOPRO] [COM] [NOREQ]
  9.  
  10. Template
  11.  
  12. FROM/M,TO/A,ALL/S,QUIET/S,BUF=BUFFER/K/N,CLONE/S,DATES/S,NOPRO/S,COM/S,NOREQ/
  13. S
  14.  
  15. Location
  16.  
  17. C:
  18.  
  19. COPY copies the file or directory specified with the FROM argument to the
  20. file or directory specified by the TO argument. You can copy several items at
  21. once by giving more than one name/pattern in the FROM argument; they should
  22. be separated by spaces. If the FROM argument is a pattern or consists of
  23. multiple names, the TO argument must be a directory.
  24.  
  25. If a TO file name already exists, COPY overwrites the TO file with the FROM
  26. file. You can use a pair of double quotation marks ("") to refer to the
  27. current directory. When used as the FROM argument, "" copies all the files in
  28. the current directory. Do not put any spaces between the double quotation
  29. marks.
  30.  
  31. If the FROM argument is a directory, only the directory's files are copied;
  32. its subdirectories are not copied. Use the ALL option to copy the complete
  33. directory, including its files, subdirectories, and the subdirectories'
  34. files. It is possible to create a directory as you copy if you are copying
  35. more than one file. To give the new directory a name, specify the directory
  36. name as the last component in the TO argument's path. This can be any name,
  37. including the same name as the original if it is a different path.
  38.  
  39. COPY prints to the screen the name of each file as it is copied. This can be
  40. overridden by the QUIET option.
  41.  
  42. The BUF= option is used to set the number of 512-byte buffers used during the
  43. copy. (Default is 128 buffers, 64 KB of RAM.) Limit the number of buffers
  44. when copying to RAM:. BUF=0 uses a buffer the same size as the file to be
  45. copied.
  46.  
  47. By default, COPY gives a TO file the timestamp of when the copy was made,
  48. rather than that of the original file. Also by default, comments attached to
  49. the original FROM file are not copied and the protection bits of the FROM
  50. file are copied to the TO file. You can override these defaults using the
  51. following:
  52.  
  53. CLONE
  54.  
  55. The timestamp, comments, and protection bits of the FROM file are copied to
  56. the TO file.
  57.  
  58. DATES
  59.  
  60. The timestamp of the FROM file is copied to the TO file.
  61.  
  62. COM
  63.  
  64. Any comment attached to the FROM file is copied to the TO file.
  65.  
  66. NOPRO
  67.  
  68. The protection bits of the FROM file are not copied to the TO file. The TO
  69. file is given standard protection bits or r, w, e, and d.
  70.  
  71. COPY displays a requester if the COPY cannot continue. When the NOREQ option
  72. is given, all requesters are suppressed. Use this in scripts to prevent a
  73. COPY failure from stopping the script to wait for a response. With the NOREQ
  74. option, the COPY command is aborted and the script continues.
  75.  
  76. Example 1:
  77.  
  78. 1> COPY File1 TO :Work/File2
  79.  
  80. copies File1 in the current directory to the Work directory in the root of
  81. the current device, renaming it File2.
  82.  
  83. Example 2:
  84.  
  85. 1> COPY Chapter#? TO DF1:Backup
  86.  
  87. copies all the files whose names start with Chapter in the current directory
  88. to the Bakkup directory on the disk in DF1:. The Backup directory is created
  89. if it does not already exist.
  90.  
  91. Example 3:
  92.  
  93. 1> COPY Work:Test TO " "
  94.  
  95. copies the files in the Test directory on Work to the current directory;
  96. subdirectories in Test are not copied.
  97.  
  98. Example 4:
  99.  
  100. 1> COPY Work:Test TO DF0:Test ALL
  101.  
  102. copies all the files and any subdirectories of the Test directory on Work to
  103. the Test directory on DF0:. If a Test directory does not already exist on
  104. DF0:, COPY creates one.
  105.  
  106. Example 5:
  107.  
  108. 1> COPY DF0: TO DF1: ALL QUIET
  109.  
  110. copies all files and directories on the disk in DF0: to DF1:, without
  111. displaying on the screen any file/directory names as they are copied. (For
  112. disks less than half full, this can be faster than DiskCopy.)
  113.  
  114. For more examples using COPY, see Chapter 8.
  115.